home *** CD-ROM | disk | FTP | other *** search
/ Collection of Internet / Collection of Internet.iso / winprogs / goslip11 / readme.tx_ / readme.tx
Text File  |  1994-04-21  |  10KB  |  189 lines

  1.  
  2.  
  3. GoSlip!                        Version: 1.1
  4.  
  5.                         by Rob Reuss
  6.                            rsr@cunyvms1.gc.cuny.edu
  7.  
  8.  
  9. VERSION CHANGES:
  10.  
  11. This version, relative to Version 1.0 of GoSlip!, should be somewhat more
  12. stable.  Although I have recompiled the program using version 3.11 of Windows,
  13. I'm not sure this will make any difference.  Some people have reported getting
  14. GPFs when using GoSlip with Windows 3.11 -- please let me know if you get any 
  15. such drastic responses.  Some minor interface changes have been made, but no
  16. substantive changes to the program such that you could not use an earlier
  17. INI file.  Because this version allows for a command line designation of
  18. an alternative initialization file (as described below), you could now set
  19. up multiple configuration by using icons with different command line's,
  20. specifiying unique initialization files according to 1) the port you want
  21. to use, 2) the applications you want to launch, 3) etc.  An environment
  22. variable is no longer necessary, instead you must keep all INI files in
  23. the same directory as the GoSlip! executable (i.e. GOSLIP.EXE).  Because of
  24. this feature, and the complications of parsing the command line, I've eliminated
  25. the command line control over individual configuration features.  Also added
  26. to this version is the ability to drag and drop an executable from Program
  27. Manager (or Norton Desktop) onto the GoSlip! icon, whereupon GoSlip! will
  28. automatically dial in using the current configuration (including a command
  29. line designated configuration), and will launch the dropped application...last.
  30.  
  31.  
  32. DESCRIPTION:
  33.  
  34. Go Slip! is a basic (VB) dialer for use with SLIP (Serial Line Interface
  35. Protocol) connections.  It will dial the phone (with DTR ignored, that is
  36. without losing the connection when it turns the line over to other 
  37. applications), negotiate a login script, launch applications and send a
  38. simple string to those applications.  The number of script entries and
  39. the number of applications that can be launched is unlimited.  The interface 
  40. is, I hope, simple to use and *almost* solid.  I have mostly tested the dialing
  41. and script routines with my own modem (an INTEL Satisfaxtion 400) so I can 
  42. make no guarantee as to how effective or efficient they will be with other 
  43. modems, given the timings involved.  The script designer and the application
  44. launcher both have timeout values available.  Also, if GoSlip! has difficulty 
  45. hanging up your modem, try changing the following setting in GOSLIP.INI:
  46.  
  47.     [Dial]
  48.     TweakTiming=1.2
  49.  
  50. You should only need to change this value within tenths of a second.  It tells
  51. GoSlip! how long to wait after sending "+++" before the modem is ready to 
  52. receive commands, but it also effects the timing of other basic modem functions,
  53. so changing the value to a much higher number may result in significant slowing
  54. in the dialing sequence.  
  55.  
  56. I welcome comments, bug reports and suggestions to the e-mail address above.  
  57.  
  58. RENUMERATION:
  59.  
  60. If you want to send me money you may: Rob Reuss, 62 Third Place, Brooklyn, NY
  61. 11231.  I would much rather receive advice and suggestions to make the
  62. program more effective.  
  63.  
  64. INSTALLATION:
  65.  
  66. Should be simple.  Uncompress the GOSLIP.ZIP file to a empty directory
  67. (you have done this already if you are reading this) and copy the files to
  68. a blank diskette.  Run SETUP.EXE from the floppy, and designate a directory
  69. when it requests it.  
  70.  
  71. Although an environment variable was necessary in GoSlip! 1.0, it is no 
  72. longer necessary.  You need only ensure that the executable (GOSLIP.EXE)
  73. is in the same directory as the initialization file (GOSLIP.INI or any
  74. other INI file specified on the command line as /C=FileName.INI).
  75.  
  76. OPERATION:
  77.  
  78. Modem/Script:
  79.  
  80. I hope that operation is obvious. MODEM/SCRIPT under WINDOWS is where
  81. you begin by entering the phone number you wish to call, the comm port
  82. for your modem and modem settings.  The initialization string should be fine
  83. for any Hayes-compatible modems.  "CR's After Connect" adjusts 
  84. the number of carriage returns that are send once the modem 
  85. CONNECTS with the remote host.  "Connect Detection" should not need to be
  86. changed unless for some odd reason you expect a connect indication other 
  87. than "CONNECT".  
  88.  
  89. Use the NEW button to create script entries, which consist of "Look For:" 
  90. (what string the program should look for once logged on), "Send:" (what the 
  91. program sends when it encounters the string) and "Announce:" (what the program 
  92. says to the user once it encounters the string).  The Timeout value indicates
  93. how long GoSlip! will look for the string.  
  94.  
  95. This will likely consist of three entries: looking for something like "Username:",
  96. sending your username, looking for "Password:", sending your password, and looking
  97. for some indication that the system is reading to receive a command to start the
  98. SLIP server on the remote system -- in my case, this is "SLIP".  
  99.  
  100. Applications:
  101.  
  102. APPLICATION under the WINDOWS menu is where you designate the applications you
  103. wish to run once the SLIP connection is established.  You need not enter any
  104. applications here, of course.  You start by using the "NEW" button (or "Select
  105. Application" for the first app you enter) and using the file dialog box to find
  106. the application you want to run.  For me, this is Peter Tattam's "Trumpman", 
  107. which is the winsock manager I use.  Whatever application you choose first will
  108. have a "Wait Time" value of 5 seconds, since you want to make sure that any
  109. applications launched after your winsock manager do not beat it to the punch.
  110. Because applications launched in this manner are being shelled asychronously 
  111. (that is, GoSlip! has no knowledge of when or if they have properly loaded)
  112. you want to make sure a manager has had enough time to load before you launch apps
  113. whose own operation will be contigent on it's operation. 
  114.  
  115. You can designate a "Name:" for the application, which will be used to broadcast
  116. to the user what is happening as the programs are being launched.  "Win State" is
  117. controlled by clicking it's button, and toggles between the available options 
  118. (Normal with focus, Normal without focus, Minimized with focus, Minimized without
  119. focus), which are how the application will appear when it runs.  "Send Text" allows
  120. you to enter a simple string that is sent to the application once it is running.
  121. The string will not be sent until after "Wait Time" specified for the app has expired.
  122. PLEASE NOTE: if you enter anything here you can only run the application either
  123. normal with focus or minimized with focus, since the application must have focus
  124. in order to receive the keystrokes.  I have used this with EUDORA by Qualcomm
  125. so that my password is sent automatically.  Please note that using GoSlip! for this
  126. purpose is risky since I haven't employed any encryption methods or such to protect
  127. your password information (maybe later).  Finally, you can use the "Switches" entry
  128. to launch your application with command line switches.  
  129.  
  130. Configure:
  131.  
  132. CONFIGURE under the OPTIONS menu allows you to set the following features.  "Persistent 
  133. Redial" will cause GoSlip! to redial the phone automatically is either
  134. a busy signal is received or if the timeout value given for "Connect" (see above)
  135. is reached.  "Speaker on during dial" -- you figure it out.  "Quit after Completion"
  136. allows you to have GoSlip! quit after the completion of a full sequence.
  137. "Autodial on Loading" is exactly what it says, and enables auto-hangup.  Just to make
  138. this clear, when under any conditions dialing is intiated, GoSlip! tests the line 1)
  139. to make sure the port is available and not already in use and 2) to hangup if the port
  140. is not in use, but a connection is still active.  Finally, "Quit after Completion" will
  141. cause GoSlip! to quit when it has finished a complete dialing and app launch sequence.
  142.  
  143. These settings may no longer be controlled by command line options.  Any command line
  144. options will always be overridden by the current configuration.  Multiple configruations
  145. are now possible through the use of different initialization files, which can be specified
  146. on the command line as follows:  
  147.                     /C=FILENAME.INI
  148.  
  149. The extension .INI must be included in order for the configuration file to be properly
  150. identified.  
  151.  
  152.  
  153. System:
  154.  
  155. This window will notify you of most actions that you or GoSlip! is taking.
  156.  
  157.  
  158. Debug:
  159.  
  160. This is a pretty cheap debug window that displays the text being "looked for" and what
  161. is going on in the communications port.  I want to give this more features to make
  162. debugging a script easier, such as a mechanism to send carriage returns.  Please give 
  163. me suggestions.
  164.  
  165. GENERAL:
  166.  
  167. Please note that the configurations options, scripts and app launch controls can be 
  168. tweaked "in situ", that is, while the system is running, and except in the obvious
  169. cases, changes will be implemented immediately.  (An obvious case would be that turning 
  170. the speaker off once the modem is dialing won't do diddly squat.)  Minimizing GoSlip!
  171. will have all the messages normally sent to the message box sent to the caption, so you
  172. can watch it's progress while minimized.   
  173.  
  174. Finally, if for some odd reason some or all of the windows don't show up on your screen
  175. when you first start GoSlip!, reduce the values found in the "WinSize" section, 
  176. particularly the "Top" and "Left" values, which end with an "T" or an "L".  GoSlip! 
  177. keeps track of you window sizes and positions, and although the default values should 
  178. fix the windows fine on a lower resolution monitor, you can certainly change these 
  179. values manually.
  180.  
  181. Next Version:
  182.  
  183. I may switch over to containing modem, dialing, scripting and application information
  184. in an Access database (i.e. *.MDB), allowing for the development of a whole database
  185. of applications that can be more easily mixed and matched in configruations.  I would
  186. like to add drag and drop capability from the file manager for setting up the application
  187. launch suite.  Also, a more sophisticated system for sending keys, such as multiple lines 
  188. of keystrokes and function keys would be nice.  
  189.